home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / workbench / fblit / fblit263a.doc < prev    next >
Text File  |  2000-02-14  |  7KB  |  240 lines
  1.  
  2. FBlit 2.63a
  3. -----------
  4. 'FBlit' is © Stephen Brookes 1997-98
  5.  
  6.  
  7.  
  8. Blah
  9. ----
  10. This software is experimental, incomplete and fundamentaly dangerous, so
  11. don't use it! I will take no responsibility for any undesirable effects
  12. resulting from the use of any software or information in this archive.
  13.  
  14.  
  15.  
  16. Distribution
  17. ------------
  18. 'FBlit' is freely distributable.
  19.  
  20.  
  21.  
  22. Required
  23. --------
  24. 020+ CPU, the faster the better.
  25. Fast RAM
  26. V39+
  27. AGA perhaps (it is untested on OCS/ECS)
  28.  
  29. The GUI requires MUI, but the GUI itself is not essential for basic use.
  30.  
  31.  
  32.  
  33. Installation
  34. ------------
  35. Use the Install script. (this does not alter your startup-sequence)
  36.  
  37. Or, do it manually...
  38.  
  39. Put 'FBlit' and 'FBlitGUI' in 'C:'.
  40. It is also a good idea to delete 'envarc:fblit.cfg', unless you really
  41. don't want to loose your old configuration. Using an old cfg isn't likely
  42. to cause trouble, but your task lists will not get updated.
  43.  
  44. In any event, if you were running a previous FBlit, you will need to reboot
  45. after installing this one.
  46.  
  47.  
  48.  
  49. Usage
  50. -----
  51. Type 'fblit', or launch from the workbench.
  52.  
  53. For a permanent installation. Add the line 'c:fblit' to your
  54. 's:startup-sequence' soon after 'env:' and 'envarc:' have been set up.
  55.  
  56. See separate doc for GUI usage.
  57.  
  58.  
  59.  
  60. What's That?
  61. ------------
  62. FBlit patches some OS functions that normally use the blitter, such that
  63. they can use the CPU, and consequently may function outside chip mem.
  64.  
  65. The patched functions are also faster and will suffer less from colour
  66. flicker on non-interleaved data.
  67.  
  68. In addition, it can force non-displayable bitmaps to be allocated in fast
  69. memory for named tasks.
  70.  
  71.  
  72.  
  73. Or in Inglish
  74. -------------
  75. Errm, ok, it will speed up graphics, and reduce chip memory usage.
  76.  
  77. FBlit will effect most OS programmes to some extent, but some are
  78. specifically targeted. By default these are 'IBrowse', 'AWeb', 'IPrefs'
  79. (responsible for WorkBench backgrounds) and a few other bits and pieces. It
  80. also allows 'NewIcons' to be used in RTG mode.
  81.  
  82. How much effect FBlit can have depends on your configuration. For instance,
  83. if you use a 4 colour PAL hires WorkBench, you may notice very little
  84. change, but if you use a 256 colour PAL hires-laced WorkBench with
  85. NewIcons, window patterns and a full screen backdrop image you certainly
  86. should notice the difference. It also depends on the speed of your
  87. processor and to a large extent on how FBlit is set up (most significantly
  88. for day to day use, wether you started it after WorkBench, or in your
  89. startup-sequence). 
  90.  
  91.  
  92.  
  93. Shiny and New
  94. -------------
  95. Using the default configuration FBlit still behaves in much the same way as
  96. it did in v2.45a but it will also allow RTG NewIcons to drag correctly and
  97. speed up some text and line rendering.
  98.  
  99. Some new tasks have been added to the default lists. Among these is
  100. 'SimCity2000' which becomes almost playable on AGA once promoted :) Though
  101. it does loose it's performance graph due to missing lines (see bellow) but
  102. I decided to include it anyway.
  103.  
  104. The most significant difference is that it is now safe (maybe) to promote
  105. just about everything! However, there are still incomplete and 'discard'
  106. patches in FBlit, so although you may not crash and burn, you should expect
  107. some missing graphics if you try promoting more than the default.
  108.  
  109. If you have any idea what I'm on about and are prepared to accept the
  110. possibly unpleasant consequences (see 'Blah' and the GUI doc), you should
  111. try setting FAllocBitMap() to 'exclude' mode and see what you can get away
  112. with, but look at the 'Don't Promote' section of this doc first!
  113.  
  114.  
  115.  
  116. Trouble And Strife
  117. ------------------
  118. FBlit appears to function perfectly on the majority of systems, but it can
  119. never be 100% compatible. There is much scope for problems.
  120.  
  121. Other software that patches the same functions as FBlit may cause trouble.
  122. MCX, MCP, CPUBlit, NewIcons etc... This applies to RTG software as well ie.
  123. CGX and P96. FBlit is fairly pointless and unlikely to function with RTG
  124. systems, especially if a gfx card is used. Although, several people have
  125. found thet running FBlit with CGXAGA covers up some of the bugs in that,
  126. but it is then very tricky to figure out what is happening when things do
  127. go wrong.
  128.  
  129. There still may be some trouble with gadget hacks like MCP's SYSIHACK.
  130. This problem seemed to fix itself with a newer MCP, but apparently came
  131. back again later?!?
  132.  
  133. On the subject of MCP, you may want to turn off it's QuickDraw patch.
  134.  
  135. There is a problem with dragged RTG NewIcons corrupting the screen on some
  136. systems. This bug is rather rare, requiring you to drag several icons
  137. arround for a while before it happens... Lovely! The only known cure for
  138. this just now is to set FDrawGList() to use the CPU for chip data, but that
  139. is horribly slow with the current blitter emulation.
  140.  
  141. Missing diagonal lines :) You might see (or not) a lot of those, but they
  142. are harmless. Currently, if any part of a rastport is in fast mem, the
  143. whole thing is classed as fast data. This means that things that aren't
  144. really in fast mem can have rendering operations blocked. Most common
  145. victims of this are vector border gadgets, especially the MUI dropdown menu
  146. gadget.
  147.  
  148.  
  149.  
  150. Don't Promote
  151. -------------
  152. There are a few things you won't want to promote due to missing gfx...
  153. (these are not accurate task names!)
  154.  
  155. Imagine (and no doubt every other 3D programme)
  156. Distant Suns 5
  157. SkandalfoClock (and probably other analogue clocks)
  158.  
  159. And things you don't want to promote because they'll crash and generally
  160. make you unhappy...
  161.  
  162. Voyager's task 'V' (this may vary with the version)
  163. CivAGA (perhaps... I'm really not sure about this one)
  164.  
  165.  
  166.  
  167. Past
  168. ----
  169. <yawn>
  170.  
  171.  
  172.  
  173. Future
  174. ------
  175. OS3.5? Or perhaps not.
  176.  
  177. The imediate priority is to upgrade the fundamental structure of FBlit so
  178. it is a little easier to work on (and at least possible for other folk to do
  179. bits of code for it, if anyone ever wants to), and to implement a partial
  180. Draw() function to cure those MUI gadgets/Imagine/SimCity2000 etc.
  181.  
  182. Another proper release version is unlikely anytime soon.
  183.  
  184.  
  185.  
  186. Built With Amiga?
  187. -----------------
  188. Development machine is...
  189. A1200 060/50(603/240) V40 etc.
  190.  
  191.  
  192.  
  193. Please Crash My Computer
  194. ------------------------
  195. Thanks to some people who like corrupt displays so much, they tried this
  196. software...
  197.  
  198.  
  199.  Rick Pratt             <http://www.geocities.com/siliconvalley/network/9715>
  200.                         (Occasional Optimizations)
  201.  
  202.  Piotr Powlow           (Bug Splatting and Ideas)
  203.  
  204.  Luca Longone           (Top Bug Hunter)
  205.  
  206.  Evan Tuer              (Endless Testing and Icon)
  207.  
  208.  Gary Colville          <http://www.personal.u-net.com/~empire>
  209.                         (Testing and Monsoon)
  210.  
  211.  James L Boyd        (More testing & AWeb info)
  212.  
  213.  Colin Wenzel           (IBrowse testing)
  214.  
  215.  Iain Barclay           (Where'd he go?)
  216.  
  217.  Oliver Borrmann        ('dopus_pattern_stuff' task)
  218.  
  219.  
  220. Thanks also to everyone who mailed me about fblit, all comments are
  221. appreciated :)
  222.  
  223.  
  224.  
  225. Up To Date
  226. ----------
  227. Latest release archives are available on Aminet as 'FBlit.lha', if there
  228. ever is another one...
  229.  
  230. Current beta versions may or may not be available from
  231. <http://www.tpec.u-net.com>
  232.  
  233.  
  234.  
  235. Contact
  236. -------
  237.  
  238.  Stephen Brookes        <sbrookes@tpec.u-net.com>
  239.                         Fido: I know, I know :(
  240.